ci: verify generated agent/skill files stay in sync with their sources#57
Open
YAMRAJ13y wants to merge 1 commit into
Open
ci: verify generated agent/skill files stay in sync with their sources#57YAMRAJ13y wants to merge 1 commit into
YAMRAJ13y wants to merge 1 commit into
Conversation
AGENTS.md tells contributors to re-run the sync scripts after editing a source file, but nothing actually enforces it, so it's easy to edit AGENTS.md or the clone-website SKILL.md and forget to regenerate - which silently drifts the 13 committed platform copies from their source. Adds a small CI job that re-runs both sync scripts and fails if the working tree comes back dirty, with a message telling you which command to run. It runs as a separate job so it doesn't slow the existing lint/typecheck/build job, and it's a no-op for branches that are already in sync.
YAMRAJ13y
force-pushed
the
ci/check-generated-files-in-sync
branch
from
65bfdfd to
1cbba59
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
AGENTS.md asks contributors to re-run the sync scripts after editing a source file, but nothing actually enforces it. It's easy to edit AGENTS.md or the clone-website SKILL.md and forget to regenerate, which quietly drifts the 13 generated platform files (Cursor, Windsurf, Gemini, Codex, Copilot, Amazon Q, Continue, Cline, OpenCode, Augment) from their source. Right now CI only runs lint/typecheck/build, so that slips through.
This adds a small
syncjob that re-runs both sync scripts and fails if the working tree comes back dirty, with a message pointing at the fix:It runs as a separate job so it doesn't slow the existing one down, and it's a no-op when things are already in sync (the scripts are deterministic — checked there's no diff on a clean master).